home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 January: Mac OS SDK / Dev.CD Jan 99 SDK2.toast / Development Kits / USBDDK_v1.0.1_updated / Examples / USBSampleStorageDriver / USBSampleStorageDriver Readme < prev    next >
Encoding:
Text File  |  1998-09-29  |  2.3 KB  |  41 lines  |  [TEXT/ttxt]
  1. USBSampleStorageDriver Readme
  2. Version: 1.0b1
  3.  
  4. The Sample Storage Shim and UT driver folder contains the sample code for a USB Shim and Unittable driver for a Mass Storage Block Device
  5.  
  6. Description
  7.  
  8. The USBSampleStorage demonstrates the use of the Mac OS USB to create a class driver for a storage class device.  This sample includes the implementation of a compatibility shim in which an ndrv is installed into the device unit table to handle IO requests by the Mac OS to the class driver.  
  9.  
  10. Building the Code
  11.  
  12. This sample was built using the Metrowerks CodeWarrior Pro 2, IDE v2.1 environment and the Mac OS USB DDK v1.0.1.  Also required, is the Universal Interfaces and Libraries 3.1.
  13.  
  14. To rebuild the project, first place the USBStorageClassDriver folder into the USBDDK:Examples: folder. The project file assumes specific access paths that are project specific. The resulting class driver, USBStorageClassDriver, along with the associated shim file, USBStorageClassShim, are built into the USBDDK:Extensions-MCWBuilt: folder.
  15.  
  16. Notes
  17.  
  18. Some quick notes on the implementation of this sample
  19.  
  20. 1. The Shim is loaded by the USB expert even before the init parade because its file creator is 'usbs' and its file type is 'ndrv'. When the expert finds this file, it looks for the exported symbol "USBShim", and calls the routine. You'll notice that the shim installs a DeviceNotification proc so that it will be called upon the kNotifyAddDevice/Interface, and kNotifyRemoveDevice/Interface events. 
  21.  
  22. Set the kDriverVendorID and the kDriverProductID constants defined in the SampleStorageDeviceID.h header file to match your device.
  23.  
  24. Bug Reports:
  25.  
  26. If you find any bugs, please send them to "usb@isg.apple.com" and include "Attn: Rich Kubota" and I will try to address them.
  27.  
  28. Questions:
  29.  
  30. For any questions which you may have with this sample or with Mac OS USB, please submit them to either the Mac OS USB mailing list, usb@apple.com, or to Worldwide Macintosh Developer Technical Support (WWDTS), dts@apple.com. If you are not familiar with the recent changes to the WWDTS support plans, please check them out at the Developer Programs web page, 
  31.  
  32. <http://developer.apple.com/programs/>
  33.  
  34. To subscribe to the Mac OS USB Developer mailing list, send an email to usb@isg.apple.com with the email subject set to "subscribe".
  35.  
  36.  
  37. Rich Kubota
  38. Apple Macintosh Developer Technical Support
  39. rkubota@apple.com
  40. 9/16/98
  41.